FaxPress WebHelp: Admin Guide > Installing the Client > Installing the Client on Windows Terminal Server

Installing the Client on Windows Terminal Server

Other Related Topics...

Running the FaxPress client software on a Microsoft Windows Terminal Server provides the same easy-to-use, integrated messaging features associated with running the FaxPress client on standalone workstations.

About Terminal Server and Citrix MetaFrame

This section summarizes the relationship of MetaFrame to Terminal Server.

About Microsoft Windows Terminal Server

The Microsoft Windows Terminal Server Edition is an extension of the Windows NT Server 4.0 and 2000 product line. In a Microsoft Windows Terminal Server/Citrix MetaFrame environment, all applications are loaded on and processed on the dedicated terminal server. Terminal Server users experience the Windows NT workstation desktop operating system and Windows-based applications centrally installed and running on the server from low cost thin-client terminals. This centralized administration results in rapid deployment of applications.

The FaxPress client, for example, must be installed only once on the Terminal Server, and then have access rights assigned, for the FaxPress client to then become available to all end-users on the network.

About Citrix MetaFrame

The Citrix MetaFrame add-on package is installed after your NT or 2000 server has the terminal server option enabled. The Citrix MetaFrame application provides Microsoft's Windows Terminal Server with additional server and client functionality by allowing any client, no matter what operating system, to connect to a Windows Terminal Server and run a Windows application through their browser. MetaFrame also provides a secure encryption option, load balancing, and enables publishing and application management from a single server in a server farm. Additionally, Citrix MetaFrame provides Citrix MetaFrame supervisor tools for the Terminal Server, which the Terminal Server alone does not have.

Citrix Published Applications

Citrix Published Applications can be an HTML application (Citrix NFuse) or a Windows 32-bit application that allows Microsoft Internet Explorer or Netscape Navigator users web-based access to applications such as Microsoft Word/ Excel, FaxPress client, VBScript and JavaScript Programming.

Castelle has tested the FaxPress client version 9.x with Citrix Windows 32-Bit Published Applications configured for Microsoft Word/ Excel/ PowerPoint/ Access.

FaxPress does not support Citrix WinFrame 1.7/1.8 for the 3.51 NT Server platform.

Citrix Standard and Non-Standard Published Apps

Castelle is compatible with Citrix Standard Published Applications. Standard Published Applications include any Windows-based 32-bit Microsoft applications such as Microsoft Office and printing applications.

Castelle cannot guarantee support for non-standard, non-Windows-based applications. These include custom applications for DOS, Unix, AS/400 running accounting, financial and payroll systems that must print to a DOS printer.

You can request a 30-day evaluation of any FaxPress unit together with an easy-to-use software developer kit (SDK) to try incorporating fax capabilities into non-standard, custom applications.

Terminal Server, Citrix, and FaxPress on your Network

The following gives you an idea of the way the Terminal Server, Terminal Server/Citrix MetaFrame clients, and FaxPress work together on a network.

Running the FaxPress Client Setup on Terminal Server

Installing the FaxPress client on a Terminal Server uses the same Castelle FaxPress Setup CD-ROM used to install the FaxPress server and client software. Running the FaxPress client software in a Windows Terminal Server environment requires you to install just one copy of the FaxPress client for Windows Terminal Server on the Terminal Server itself. The FaxPress client features then become accessible to all users on the network.

The FaxPress client for Windows Terminal Server is designed for Windows Terminal Server and Citrix only, and will not work on other network installs.

Requirements

The FaxPress client for Windows Terminal Server supports these Terminal Server editions:

Windows NT Server 4.x, Terminal Server Edition
Windows 2000 Server, Terminal Services

Before installing the FaxPress client for Terminal Server, please confirm:

you are, at minimum, using FaxPress version 6.3, Service Pack 2, rev B or, preferably, FaxPress 9.x.
the FaxPress server software is installed on a standalone workstation or file server, not the Terminal/Citrix Server. Refer to your FaxPress supervisor and User’s Guide for detailed FaxPress server software installation instructions.
the FaxPress server is operational, i.e.- can send and receive faxes.

Make sure you have not installed the FaxPress server software on the Terminal Server machine.

If you are running FaxPress version 5.x or older, uninstall it, then upgrade to FaxPress 9.x.

Preparing the Terminal Server

Before installing the FaxPress client for Windows Terminal Server, make sure you have:

set root drive mapping and run logon and compatibility scripts for each Terminal Server user. Refer to the Microsoft Knowledge Base: http://support.microsoft.com/support/kb/ and the Microsoft Terminal Server page: http://www.microsoft.com/ntserver/terminalserver/ for additional information regarding drive mapping, logon and compatibility scripts.
created and configured user profiles for any applications intended for integration with FaxPress – Microsoft Outlook, for example.

Next, be sure to:

disable all anti-virus programs running on the Terminal Server.
close the Microsoft Outlook client and remove Microsoft Outlook from the StartUp folder. (Start>Programs>StartUp)
close all programs and reboot. This guarantees that Microsoft email is not running in the background.

Running the Setup - Important Information!

Running the FaxPress Client for Windows Terminal Server setup is different from running the other FaxPress client installations, in that the Terminal Server must be in install mode for the required compatibility scripts to run during setup.

For the Terminal Server to be in install mode and for the required compatibility scripts to run during setup, you will have to exit out of the FaxPress setup, and install the FaxPress client from the Windows Add/Remove Programs Control Panel.

Installing the FaxPress client from Add/Remove Programs in the Control Panel automatically puts the Terminal Server in install mode. In fact, if you are running the installation on a Windows 2000 server, the following message will appear when the FaxPress setup is launched.

Follow these steps to install the FaxPress client for Terminal Server:

1. Place the FaxPress Setup CD into your computer’s CD-ROM drive. The Castelle FaxPress Setup screen will launch automatically.
2. Select Exit. DO NOT select Install FaxPress from the Castelle FaxPress Setup screen. Select Exit.

The Terminal Server must be in install mode for the required compatibility scripts to run during setup. You must install the FaxPress client from Add/Remove Programs in the Control Panel to automatically put the Terminal Server in install mode.

3. After exiting out of the Castelle Fax Press setup, open your Add/Remove Programs Control Panel. (Start>Settings>Control Panel>Add/Remove Programs) The Add/Remove Programs interface and procedure will vary depending on what Windows OS you’re running.
4. From the Control Panel window, double-click on Add/Remove Programs.From the Add/Remove Programs Properties window, click Install.
5. Click Next>.
6. In the Run Installation Program window, install.exe will appear in the Command line for installation program field. Click Next>.

 

7. In the Change User Option window, select All users begin with common application settings, then click Next>.

 

8. In the Welcome to FaxPress Installation screen, click Next>.

 

9. From the Select Components screen, select Install FaxPress Client for Microsoft Terminal Server, then click Next>.

 

10. In the Default Protocol window, select the TCP/IP, IPX/SPX, or NetWare 5 radio button, then click Next>.

 

11. In the Destination path screen, confirm the Destination Folder is Drive letter:\Program Files\Castelle\FaxPress where Drive letter is the NT Terminal Server root directory. Make sure the Castelle files are copied to the WinNT root drive only. Do not copy the Castelle files to any other mapped directory. Click Next>
12. .The Shared Directory screen requires you to click Browse to specify a shared directory for the FaxPress host.ip file. This folder must be accessible to all Terminal Server users and should be located on the Terminal Server machine.
13. In the Choose Folder window, select FaxPress.
14. Click Next> .

 

15. The Personal Folders screen requires you to specify a location for your Personal Folders directory. Click Next> to select the default location, or Browse to select a different one.
16. Use the Language screen to select the language of the FaxPress interface. English is the default.
17. The FaxPress Fax Report feature is only compatible with the Crystal Report version 9.2.0.448. If the Terminal Server is running any version of Crystal Report other than 9.2.0.448, click No. If the Terminal Server is not running any version of Crystal Report, or if the version is 9.2.0.448, click Yes.
18. In the Select Program Folder window, click Next>.
19. The FaxPress Outlook Direct for Terminal Server clients provides you the option of installing the FaxPress Outlook Direct email gateway. Outlook Direct, a FaxPress 9.x feature, offers seamless fax/email integration, offering users the ability to send and receive faxes right from the Outlook mail client interface. Check the Install FaxPress Outlook Direct box and click Next> to install Outlook Direct. Otherwise, click Next>.

FaxPress Outlook Direct, formerly called Exchange Direct, is a client-side service software option that provides a simplified, cost-effective way for Microsoft Outlook users to send and receive faxes. The Castelle FaxPress Transport, a service added to your email profile, connects Outlook to the FaxPress server. Client rather than server-based, Outlook Direct has the ability to operate independently of an Exchange server, making it ideal for smaller networks. Outlook Direct is not the ideal choice, however, for a remote, dial-up or Virtual Private Network connection.

Refer to the FaxPress Email Gateways Guide for information on Outlook Direct fax addressing requirements.

20. In the Setup Complete window, select No, I will restart my computer later, then click Finish to exit the FaxPress Setup Wizard and return to Microsoft’s Installation Program to complete the setup. The FaxPress client installation will be incomplete if you reboot before finishing Microsoft’s installation program.

 

21. When the After Installation screen appears, indicating you’ve returned to the Microsoft Add/Remove Programs wizard, click Next>.

 

22. When the Finish Admin Install window appears, click Finish, then reboot the Terminal Server. After rebooting, log in to the FaxPress client to send and receive test faxes.

Setting up the FaxPress Client and DCX Print Driver for Published Applications

For attached files to be converted to faxable format, and transmitted through the FaxPress, you must configure the DCX Print Driver for Published Applications on Citrix and Terminal Server. Setting up the DCX Print Driver for Published Applications on Citrix and Terminal Server requires you to:

Download the FaxPress 9.x from Castelle's website at http://www.castelle.com. This version provides the DCX Driver for Terminal Services.
Edit the existing Published Application or create a new Published Application.Once you've created a published application to support the FaxPress DCX print driver, you'll need to modify the application string to support 'Fax DCX print driver'.

Known issues exist with ASP and SAP Custom Databases and Applications printing to the Fax DCX Printer.

To set up an Adobe published app, for example, follow these steps:

1. For each seamless published app, from the Citrix console, right-click on the application and select Properties.
2. On the Application Location tab, in the Command Line box, insert the text:

"C:\Program Files\Castelle\FaxPress\Daemon.exe" -P

before the application name. Citrix will add the quotes for you. For instance, to publish Adobe Acrobat Reader, you'd start with the application command line:

"C:\Program Files\Adobe\Acrobat 5.0\Reader\AcroRd32.exe"

then change it to read:

"C:\Program Files\Castelle\FaxPress\Daemon.exe" -P"C:\Program Files\Adobe\Acrobat 5.0\Reader\AcroRd32.exe"

Make sure the path names are entered with no spaces.

To set up a Microsoft Word 97 published app:

1. For each seamless published app, from the Citrix console, right-click on the app and select Properties
2. In the Application Location tab, in the Command Line box, insert the text:

"C:\Program Files\Castelle\FaxPress\Daemon.exe" -P

before the application name. For instance, to publish Adobe Acrobat Reader, you will start with the application command line:

"C:\Program Files\Microsoft Office\Office\WinWord.exe"

Citrix will have put quotes around the path name for you.

Next, modify this to read:

"C:\Program Files\Castelle\FaxPress\Daemon.exe" -P"C:\Program Files\Microsoft Office\Office\WinWord.exe"

Make sure the path names are entered with no spaces.

The daemon is provided with concurrency issue handling; it internally ensures that only one copy of it is active. Application open and close order is irrelevant; if the app with the currently active daemon is closed, one of the other daemons is awakened and becomes active. Inactive daemons, according to the MS discussion of the API calls, take up no CPU time.

Adding Outlook Direct Transport to User Profiles

The FaxPress Outlook Direct service software enables Terminal Server clients to use the FaxPress server to send and receive faxes via Exchange or Outlook.

For fax/email integration, the FaxPress Outlook Direct Transport must be added to the list of available services for each user’s Mail profile, then configured with both the FaxPress login and password information, and the user’s Outlook mailbox name.

The transport cannot be configured while the mail client is running. Always close the Outlook or Exchange client when modifying transport information.

1. Launch a Terminal Server client. Open the Mail or Mail and Fax control panel. (Start>Settings>Control Panel> Mail)
2. In the mail Properties window, click Show Profiles.
3. Select the User Profile to edit, then click Properties.
4. In the user’s Properties window, with the Services tab selected, click Add.
5. In the Add Services to Profile window, select FaxPress Exchange Direct, and click OK.
6. The Login tab of the FaxPress Transport Properties dialog box provides the information required for the transport to log in to the user’s FaxPress account. Select the FaxPress Server name or IP address from the pulldown menu. Enter the user’s FaxPress User Name and Password, then click the Verify Login button.

 

Login is automatic and occurs when you open the mail client. If the transport can’t log onto the server, you will be notified only after you try to send a fax. Use the Verify Login button to confirm login.

7. A Login successful message will appear if the transport is able to connect to the Faxpress server. Click OK.
8. Select the General tab, then enter the user’s Exchange or Outlook User Name. Select FAX from the Email Type pulldown menu. Click OK, then exit.
9. From the user’s mail Properties dialog box, and select the Delivery tab. Select FaxPress Exchange Direct from the list of information services, then click the Up arrow to place it first in the list.
10. .Select the Addressing tab, then click Add. . .
11. From the Add Address List window, select Contacts and click Add. Click Close to save and exit.
12. Contacts should now appear as an address list option. Click Apply, then OK to exit.
13. Close all programs and reboot the Terminal Server. After rebooting, have all the users log in and send test faxes to confirm the setup’s success. Also, make sure any shared resources, such as network drives or printers, are set up for each user before using FaxPress.

Installing on a Novell Network

In a Novell Netware environment with an active Microsoft Windows Terminal Server, FaxPress uses TCP/IP for FaxPress server to client communication.

To confirm that the FaxPress is able to communicate using TCP/IP:

the FaxPress server must be assigned an IP address.
the FaxPress client must be set to use TCP/IP as the default network protocol, a selection made during the client setup.
the FaxPress must be able to successfully send and receive test faxes.

To assign the FaxPress Server an IP address, follow these steps:

1. On a Windows 95/98, Me, NT or 2000 workstation with the FaxPress Client for Administrators installed, launch the FaxPress Configurator for IPX/SPX. (Start>Programs>FaxPress>Administration Tools> FP Configurator for IPX/SPX)
2. In the FaxPress Configuration (IPX protocol) window, enter your FaxPress Server’s serial number, click Show Settings, then IP settings.
3. .Enter an IP address in the FaxPress IP Address field, and a subnet mask address in the IP Mask field. Click the Set, then the Exit button. Reboot the FaxPress server.

Leave the Gateway and Master File Server IP Addresses blank

Removing FaxPress from the Terminal Server

Follow these steps to remove FaxPress from the Terminal Server:

1. Go to Start Menu>Programs>Command Prompt CD to C:/FaxPress/PrintDriver and type in this command: DcxSetup -d to uninstall the DCX Print Driver.
2. From the Control Panel click on Add/Remove Programs. Select the FaxPress program and remove it from the program list.
3. Go to Start Menu/Find/Files Or Folders and type in FaxPress.INI and delete all the FaxPress.INI files
4. Delete all Castelle entries from registry: HKEY_CURRENT_USER/SOFTWARE and HKEY_LOCAL_MACHINE/SOFTWARE
5. Reboot the NT Terminal Server system.

 

FaxPress WebHelp
Last Updated: 9/12/2007

E-mail this page

Castelle

855 Jarvis Drive, Suite 100

Morgan Hill, CA 95037

Toll-free 800.289.7555

Tel 408.852.8000

Fax 408.852.8100

www.castelle.com